home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / modula2 / cal.com / CAL.DOC < prev    next >
Encoding:
Text File  |  1989-06-03  |  5.7 KB  |  147 lines
  1.                         June 3, 1989
  2.  
  3.  
  4. CAL - Calendar, Version 1.00 - A simple calendar program with
  5. Modula-2 source code included.
  6.  
  7. Contents:
  8. =========
  9. Purpose
  10. Installation
  11. Commands
  12. Program background
  13. Closing remarks
  14.  
  15. Purpose:
  16. ========
  17. This program is directed at two very different groups of people.
  18.  
  19. The first group is composed of non-programmers.  These people
  20. are mainly interested in what a program can do for them.  For
  21. these people, my CAL program is an free program that can be used
  22. as a sort of perpetual calendar.  Although there are other
  23. programs that can do many of the same things, since this is a
  24. stand-alone, non-memory resident program, it takes up very
  25. little disk space and memory, and there is little chance of
  26. conflicts with other programs.
  27.  
  28. The second group is composed of programmers who would appreciate
  29. having the source code available for a "real" working program,
  30. to customize or use as an example from which they can study and
  31. learn.  For these people, the provided "library" routines can be
  32. used as a starting point.
  33.  
  34. The source code library files TIME.DEF and TIME.MOD are by no
  35. means complete.  In fact, they have been intentionally kept to a
  36. minimum.  For example, although the files are named TIME, there
  37. are no definitions or routines to handle time in hours, minutes,
  38. seconds, etc.
  39.  
  40. Although I only mentioned two groups, there is a third group.
  41. These are the high-powered programmers who can write their own
  42. programs from scratch, probably better than I could.  My
  43. programs are not meant for them.
  44.  
  45. Installation:
  46. =============
  47. To use the calendar program as is, just copy the CAL.EXE file to
  48. the disk from which you will be invoking the CAL command.  If
  49. you are using a hard disk, it is suggested that you copy this
  50. file to a directory included on your PATH.
  51.  
  52. Commands: 
  53. =========
  54. Type CAL to start the calendar.  The program will read your
  55. system clock and display the current month and year as the first
  56. page.  The current day will be highlighted.
  57.  
  58. Use the direction keys to move the highlight around in the
  59. Calendar Window.  <Left> takes you to the previous day; <Right>
  60. the next day.  <Up> takes you to the previous week; <Down> the
  61. next week.  <PgUp> moves to the previous month; <PgDn> the next
  62. month.  <Ctrl-PgUp> takes you to the previous year, keeping the
  63. same month and day; <Ctrl-PgDn> the next year.  <Home> will
  64. return you the starting date.
  65.  
  66. Pressing <Return> or <Esc> will take you out of the program.
  67.  
  68. Program background:
  69. ===================
  70. There are all sorts of things for which time and date routines
  71. are useful.  Payroll and time scheduling programs are just two
  72. examples.
  73.  
  74. Although established algorithms exist for computations such
  75. converting a date to an ordinal number and for calculating the
  76. day of the week, I haven't run across the derivations for these
  77. - just the formulas that I'm supposed to take on faith.  I like
  78. to use algorithms that I can easily understand and in which I
  79. can have confidence.  I therefore wrote my own routines for
  80. these based on my understanding of the Gregorian calendar.
  81.  
  82. Efficiency was not my primary goal.  However, I have attempted
  83. not to be too inefficient.
  84.  
  85. The source code was written for the JPI TopSpeed Modula-2
  86. compiler.  There was some attempt to keep the code portable.
  87. This does not mean that modification for use on another compiler
  88. won't be necessary however.
  89.  
  90. If one understands the underlying algorithms, it should not be
  91. too difficult to adapt the code to another Modula-2 compiler
  92. system (including library) or to another language, such as C.
  93.  
  94. Closing remarks:
  95. ================
  96. Interested users are encouraged to contact me with comments, bug
  97. reports, suggestions and questions about the program.  I can be
  98. reached at the addresses below:
  99.  
  100.  
  101.                 By conventional mail:
  102.                 ---------------------
  103.                Raymond T. Kaya
  104.         P. O. Box 1436
  105.                 Honolulu, HI  96806
  106.  
  107.  
  108.         By electronic mail:
  109.                 -------------------
  110.                CompuServe:  71230,2500
  111.                GEnie:       R.KAYA1
  112.  
  113.          ----------------end-of-author's-documentation---------------
  114.  
  115.                         Software Library Information:
  116.  
  117.                    This disk copy provided as a service of
  118.  
  119.                         The Public (Software) Library
  120.  
  121.          We are not the authors of this program, nor are we associated
  122.          with the author in any way other than as a distributor of the
  123.          program in accordance with the author's terms of distribution.
  124.  
  125.          Please direct shareware payments and specific questions about
  126.          this program to the author of the program, whose name appears
  127.          elsewhere in  this documentation. If you have trouble getting
  128.          in touch with the author,  we will do whatever we can to help
  129.          you with your questions. All programs have been tested and do
  130.          run.  To report problems,  please use the form that is in the
  131.          file PROBLEM.DOC on many of our disks or in other written for-
  132.          mat with screen printouts, if possible.  The P(s)L cannot de-
  133.          bug programs over the telephone.
  134.  
  135.          Disks in the P(s)L are updated monthly, so if you did not get
  136.          this disk  directly from the P(s)L,  you should be aware that
  137.          the files in this set may no  longer be the current versions.
  138.  
  139.          For a copy of the latest monthly software library newsletter
  140.          and a list of the 1,800+ disks in the library, call or write
  141.  
  142.                         The Public (Software) Library
  143.                               P.O.Box 35705 - F
  144.                            Houston, TX 77235-5705
  145.                                (713) 665-7017
  146.  
  147.